
            Common Controls Replacement Project FolderTreeview Control
                         Version 1.00.0006 Oct 30, 1999

                                 Member Attributes

Module name: FolderTreeview
CCRP FolderTreeview Control

Events: (16)
============

Event Click
Occurs when the user presses and then releases a mouse button over an object.

Event Collapse
Occurs both before, and after, a Folder is collapsed. If PreCollapse is True, the
Folder has not yet collapsed, and the Cancel parameter can be set to False canceling
the collapse. If False, the Folder has collapsed, and Cancel is ignored.

Event DblClick
Occurs when the user presses and releases a mouse button and then presses and releases
it again over an object.

Event EnumContentsProc
Occurs after a Folder object's EnumContents method is invoked, for every item contained
within the Folder. If DontFreePidls and Continue are set to True, the current item's
pidls will not be freed, and the next item in the Folder will be enumerated. (hidden)

Event Expand
Occurs both before, and after, a Folder is expanded. If PreExpand is True, the Folder
has not yet expanded, and the Cancel parameter can be set to False canceling the expand.
If False, the Folder has expanded, and Cancel is ignored.

Event FolderClick
Occurs when a Folder object is either clicked, or becomes selected.

Event FolderUpdate
Occurs when AutoUpdate is set to True, and a Folder object has been updated as a result
of a change in the shell. The Folder object represented by FolderName may be invalid.

Event HScroll
Occurs after the FolderTreeview control window has been scrolled horizontally.

Event KeyDown
Occurs when the user presses a key while an object has the focus.

Event KeyPress
Occurs when the user presses and releases an ANSI key.

Event KeyUp
Occurs when the user releases a key while an object has the focus.

Event MouseDown
Occurs when the user presses the mouse button while an object has the focus.

Event MouseMove
Occurs when the user moves the mouse.

Event MouseUp
Occurs when the user releases the mouse button while an object has the focus.

Event SelectionChange
Occurs both before, and after, a Folder is selected. If PreChange is True, the Folder
has not yet become selected, the Cancel parameter can be set to False canceling the
selection.  If False, the Folder has become selected, and Cancel is ignored.

Event VScroll
Occurs after the FolderTreeview control window has been scrolled vertically.

Properties: (24)
================

Property Appearance
Returns/sets whether or not the FolderTreeview control is painted with 3-D effects.
(read-only at runtime)

Property AutoUpdate
Returns/sets a value determining whether the FolderTreeview is automatically updated
when any changes occur within the shell.

Property BorderStyle
Returns/sets the FolderTreeview control's border style. (read-only at runtime)

Property CheckBoxes
Returns/sets a value determining whether the FolderTreeview displays checkboxes to the
left of each Folder object's icon.

Property ComCtlVer
Returns the major and minor values of the currently installed version of Comctl32.dll.
(not shown in property browser)

Property Enabled
Returns/sets a value that determines whether an object can respond to user-generated
events.

Property FirstVisibleFolder
Returns a reference to the first visible Folder object in the FolderTreeview control.
(not shown in property browser)

Property HasButtons
Returns/set a value that determines whether a button (""+"") is visible to the left side
of each parent folder.

Property HasLines
Returns/set a value that determines whether dashed lines are drawn that link child
folders to their corresponding parent folder.

Property HasLinesAtRoot
Returns/sets a value that determines whether a dashed line is drawn to the left of the
RootFolder. The HasLines property must be set for this property to take affect.

Property HiddenFolders
Returns/sets a value that determines whether folders with the hidden file attribute are
displayed in the FolderTreeview control.

Property HideSelection
Returns/set a value that determines whether the selected folder will not remain selected
when the FolderTreeview loses focus.

Property hWnd
Returns the handle of the FolderTreeview control's child treeview window. (hidden)

Property Indent
Returns/sets the distance in pixels that folder icons are indented from the left side of
the FolderTreeview control window's internal client area.

Property IntegralHeight
Returns/sets a value indicating whether the FolderTreeview control adjust its size
vertically so that its folder icons are not partially displayed. (read-only at runtime)

Property MouseIcon
Returns/sets a custom mouse icon.

Property MousePointer
Returns/sets the type of mouse pointer displayed when over part of an object.

Property OverlayIcons
Returns/sets a value determining whether shared folders are displayed with their
associated network share overlay icons.

Property RootFolder
Returns/sets the Folder object that is the root of the FolderTreeview control window's
folder hierarchy.

Property SelectedFolder
Returns/sets the Folder object that is currently selected in the FolderTreeview control
window.

Property SelectionDelay
Returns/sets the time in milliseconds that the second SelectionChange event
(PreChange = False) is delayed. Valid values are between 0 and 5000.

Property Shell32Ver
Returns the major and minor values of the currently installed version of Shell32.dll.
(not shown in property browser)

Property Tooltips
Returns/sets a value indicating whether tooltips are shown containing the entire
display name of a folder whose display name is partially obscured.

Property ValidateSelection
Returns/sets a value determining whether Folder objects are validated when selected.
If True, and a folder being selected either no longer exists, or is unavailable, the
FolderTreeview will show an error message box, and subsequently refresh its tree.

Property VirtualFolders
Returns/sets a value that determines whether virtual non-file system folders are
displayed in the FolderTreeview control.

Methods: (6)
============

Sub AboutBox
Displays the FolderTreeview's About dialog box. (hidden)

Function AreSameFolders
Returns a value that determines if two separate Folder object instances represent the
same shell folder.

Function GetSpecialFolderName
Returns the display name or path of a special shell folder specified by a
ftvSpecialFolderConstants value. Can be assigned directly to either the RootFolder or
SelectedFolder properties.

Function GetVisibleCount
Returns the number of Folder objects that will fit vertically within the internal client
area of the FolderTreeview control.

Function HitTest
Returns a reference to the Folder object located at either the specified x and y
coordinates, or the coordinates of the cursor's current position. If specified, the
FolderElement parameter is filled with the Folder's ftvHitTestConstants value.

Sub Refresh
Forces the FolderTreeview control to re-read the shell's namespace and refresh display
of all of its currently loaded folders.
